home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds / rpn.man < prev    next >
Encoding:
Text File  |  1989-06-07  |  4.9 KB  |  223 lines
  1. ' Copyright 1989 Regents of the University of California
  2. ' Permission to use, copy, modify, and distribute this
  3. ' documentation for any purpose and without fee is hereby
  4. ' granted, provided that this notice appears in all copies.
  5. ' The University of California makes no representations about
  6. ' the suitability of this material for any purpose.  It is
  7. ' provided "as is" without express or implied warranty.
  8. ' 
  9. ' $Header: /sprite/lib/forms/RCS/proto.man,v 1.3 119/01/09 11:43:01 ouster Exp $ SPRITE (Berkeley)
  10. ' 
  11. .so \*(]ltmac.sprite
  12. .HS RPN cmds
  13. .BS
  14. .SH NAME
  15. rpn \- reverse polish notation visual desk calculator
  16. .SH SYNOPSIS
  17. .nf
  18. \fBrpn\fR
  19. .BE
  20.  
  21. .SH DESCRIPTION
  22. .PP
  23. \fBRpn\fP is a stack-based desk calculator with a screen-oriented front end.
  24. This calculator is very similar, in many respects, to old
  25. Hewlett-Packard scientific calculators.
  26. The available commands are listed in a menu at the top of the
  27. screen.
  28. the first few elements of its computation stack are listed next.
  29. At the bottom of the screen is a data entry area.
  30. \fBRpn\fP uses ``reverse polish notation'', or stack-oriented commands.
  31. Thus the basic syntax is
  32. .DS
  33. \fIarg\fR \fIarg\fR \fIop\fR
  34. For example: 47 358 +
  35. .DE
  36. .PP
  37. This command pushes two values on the stack (47 and 358),
  38. then applies the operation (+) to those two values.
  39. Operands are popped from the stack and replaced by the result of the operation.
  40. Items can be pushed onto the stack one at a time,
  41. or more complicated expressions can be entered all on one line:
  42. .DS
  43. For example: 47 179 2 * +
  44. or: 47 179 * 2 +
  45. .DE
  46. .PP
  47. Note that the previous two examples are different and produce different
  48. answers.
  49. .SH "ARITHMETIC OPERATIONS"
  50. .IP + 11
  51. Addition
  52. .IP - 11
  53. Subtraction
  54. .IP * 11
  55. Multiplication
  56. .IP / 11
  57. Division
  58. .IP mod 11
  59. Modulo
  60. .IP ** 11
  61. Exponentiation
  62. .IP +- 11
  63. Negation
  64. .IP 1/x 11
  65. Inverse
  66. .IP min 11
  67. Minimum of two arguments
  68. .IP max 11
  69. Maximum of two arguments
  70. .IP abs 11
  71. Absolute value
  72. .IP maxuint 11
  73. Generates the maximum unsigned integer
  74. .IP maxint 11
  75. Generates the maximum signed integer
  76. .SH "LOGICAL OPERATIONS"
  77. .IP "and (&)" 11
  78. .IP "or (|)" 11
  79. .IP "xor (^)" 11
  80. .IP "not (~)" 11
  81. .IP "shr (>>)" 11
  82. Shift right
  83. .IP "shl (<<)" 11
  84. Shift left
  85. .SH "STACK OPERATIONS"
  86. .IP xy 11
  87. Swap top two stack elements
  88. .IP copy 11
  89. Pushes a copy of the top of stack
  90. .IP clrx 11
  91. Clear x, the top of the stack
  92. .IP y 11
  93. Clear y, the next to top of the stack
  94. .IP clrs 11
  95. Clear the whole stack
  96. .IP "clrm \fIN\fP" 11
  97. Clear register number N
  98. .IP "sto \fIN\fP" 11
  99. Store to register number N
  100. .IP "sto+ \fIN\fP" 11
  101. Add to register number N
  102. .IP "sto- \fIN\fP" 11
  103. Subtract from register number N
  104. .IP "rcl \fIN\fP" 11
  105. Recall register number N to top of stack
  106. .IP "disp \fID\fP" 11
  107. Display D places before decimal point.
  108. Rpn uses exponential notation if a number can't be display in this field width.
  109. .IP oct 11
  110. Display stack in octal
  111. .IP nooct 11
  112. Remove octal stack display
  113. .IP hex 11
  114. Display stack in hexadecimal
  115. .IP nohex 11
  116. Remove hexadecimal stack display
  117. .IP signed 11
  118. (unknown function)
  119. .IP unsigned 11
  120. (unknown function)
  121. .IP deg 11
  122. Degree mode
  123. .IP rad 11
  124. Radian mode
  125. .SH "TRIG FUNCTIONS"
  126. .IP sin 11
  127. Sine
  128. .IP cos 11
  129. Cosine
  130. .IP tan 11
  131. Tangent
  132. .IP sinh 11
  133. Hyperbolic sine
  134. .IP cosh 11
  135. Hyperbolic cosine
  136. .IP tanh 11
  137. Hyperbolic tangent
  138. .IP asin 11
  139. Arcsine
  140. .IP acos 11
  141. Arccosine
  142. .IP atan 11
  143. Arctangent
  144. .IP asnh 11
  145. Arc-hyperbolic sine
  146. .IP acnh 11
  147. Arc-hyperbolic cosine
  148. .IP atnh 11
  149. Arc-hyperbolic tangent
  150. .IP pi 11
  151. Generate the constant pi
  152. .SH "LOGARITHMIC FUNCTIONS"
  153. .IP "ln" 11
  154. Natural log
  155. .IP "log" 11
  156. Base-10 log
  157. .IP "lg2" 11
  158. Base-2 log
  159. .IP exp 11
  160. Exponential
  161. .IP alog 11
  162. Base-10 exponential
  163. .IP alg2 11
  164. Base-2 exponential
  165. .SH "STATISTICAL FUNCTIONS"
  166. .IP s+ 11
  167. Statistical accumulation.
  168. This accumulates statistical data on two variables, X and Y, into numbered
  169. registers.  The functions var, sd and rms use this data.  Given a
  170. series of n correlated X and Y pairs, enter each pair in the x and y
  171. registers, and execute s+.  The data is accumulated as follows:
  172. .DS
  173. sto 10        n
  174. sto 9        sum XY
  175. sto 8        sum Y**2
  176. sto 7        sum Y
  177. sto 6        sum X**2
  178. sto 5        sum X
  179. .DE
  180. .IP s- 11
  181. This is the inverse of s+ and is used to remove incorrectly entered X-Y pairs.
  182. .IP var 11
  183. The variance of X and Y is computed in registers x and y,
  184. and also in registers 3 and 4.
  185. .IP sd 11
  186. Standard deviation of X and Y is computed in registers x and y,
  187. and also in registers 3 and 4.
  188. .IP rms 11
  189. Root-mean squared of X and Y is computed in registers x and y,
  190. and also in registers 3 and 4.
  191. .SH "MISCELLANEOUS FUNCTIONS"
  192. .IP sqrt 11
  193. Square root
  194. .IP gcdv 11
  195. Greatest common divisor
  196. .IP comb 11
  197. Combinatorial ??
  198. .IP fact 11
  199. Factorial
  200. .IP lrgn 11
  201. Lagrange ??
  202. .IP trun 11
  203. Truncate
  204. .IP roun 11
  205. Round
  206. .IP rand 11
  207. Generate a random number
  208. .SH "CONVERSION FUNCTIONS"
  209. .IP d-r 11
  210. Degrees to radians
  211. .IP r-d 11
  212. Radians to degrees
  213. .IP r-p 11
  214. Rectangular to polar (two dimensions)
  215. .IP p-r 11
  216. Polar to rectangular
  217. .IP r-s 11
  218. Rectangular to spherical (three dimensions)
  219. .IP s-r 11
  220. Spherical to rectangular
  221. .SH KEYWORDS
  222. calculator, stack, reverse polish notation
  223.